home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
edit
/
pcvile.zip
/
VILE.HLP
< prev
Wrap
Text File
|
1991-07-21
|
28KB
|
634 lines
Welcome to pcvile
-----------------
This version of vile differs from the distributed source code of
vile version 3 in a few ways which I shall make clear here:
1) The cursor keys, page up/down and insert/delete keys have been
compiled into the program (I tried binding but due to a bug this
didn't seem to work too well) so this should keep the "I don't
like using hjkl" brigade happy!
2) Vile distinguishes between a write of a region ':1,20w' and a
write of a whole file ':w' and so each of these have been given
different letters. The region write is ':1,20W' and the file
write remains ':w'. ':wq' remains the same.
3) I have implemented the emacs ^X-O command to flip between windows
as I tend to use this quite a bit rather then ^N and ^P which is
the vile standard.
4) You can force this version of vile into one of three screen modes:
25, 43 and 50 line. I have had problems with the 43 line mode
on AST premium 286 workstations (the only EGA I can lay my hands on)
so I apologise if it doesn't work, the 25 and 50 line modes work
fine though. The default is 50 lines (for various reasons!) so if
you have a mono or cga monitor you'll have to change your vile.rc
file.
There are two ways to set the screen mode:
a) with a command line option: -2 -4 -5 are 25, 43 and 50 line resp.
b) by adding "setg screen {25|43|50}" into your vile.rc file.
Note you should NOT do this from within the editor.
Also, if you shell out in 50 line mode, make sure you are in 50 line
mode before you exit the dos shell, otherwise you end up with a 50
line edit window with only the top 25 displayed!
Personally I find 50 line mode very usable, but I know people who
have difficulty reading it so just put setg screen 25 in the vile.rc
file to save your eyesight.
5) Shelling out to dos can be done by using ^Z, however this doesn't
seem to want to work if vile has run out of memory.
There are still plenty of bugs I know, the main one I want to get done
first being memory, ie running out, and the vi compatibility isn't
100% but I like it, and I hope some others might too.
I am taking responsibility for any pcvile bugs (please check the enclosed
known bug list first though) and I'll then split them into pc
specific, which I will deal with, and vile general bugs, which I will pass
on to Paul Fox so that they can be fixed for version 4.
Getting along with vile
-----------------------
Use Ctrl-D and Ctrl-U to scroll through this help information.
Type Ctrl-O to make this the only window on the screen.
The only vile commands described herein are those not
present in vi, or differing greatly from those in vi.
There is a section at the bottom describing other differences
between vile and vi.
First, to leave vile, use any of the following:
:q
:quit
:exit
:wq (writes the file before quitting)
:q! (quits without writing changes!)
Q
ZZ (will write all unwritten buffers)
^X-^C (don't know why. _They_ don't put in ":q" for _us_!)
To get help (probably just this text), use any of:
:h
:help
^X-^H
^A-^H
General Remarks
---------------
Vile holds text in "buffers". Usually, these correspond to a file
that you are editing, but not always. For instance, a buffer
might be used to display this help text, or to hold the output
of a shell command that you have run. Buffers have names, and
these usually match the names of the files they contain.
Buffers are sometimes displayed in windows. A buffer may be
displayed in more than one window at the same time. There is
no such thing as a hidden window. All existing windows are on
the screen. There may, however, be hidden buffers, which are not
currently associated with any window.
All yank/delete registers (the default unnamed register, the numbered
registers ("1-"9) that hold line-deletes, and the named registers
("a-"z)) are global to the editor, and not attached to any single
buffer. Thus you can delete text in one buffer and put it back in
another.
Undo operations are attached to a buffer, not a window. Thus if
you have two windows to the same buffer, and make a change in one,
you can undo it in the other.
Buffer manipulation commands:
-----------------------------
_ Show a history list of the up to 9 most recently visited
buffers. Follow this command with a digit to select that
buffer, or simply repeat it ("__") as a synonym for "_1".
Modified buffers are preceded by a '*' in the history list.
There are many different ways to get the previous file:
__
_1
1_
:p
:e#
^^ (ctrl-^) (but many keyboards can't produce this)
:e Edit a file. If the file is already in a buffer, that buffer
will be recalled into the current window.
:e! Re-edit a file. A different filename can be given, but the
buffer name will not change to match it.
^X-e Edit the file whose pathname appears under the cursor. That
is, if you are editing a makefile, you could edit one of the
source files by placing the cursor at the start of its name
and using this command.
:n Go to the next buffer. "next" means least recently used.
:rename Rename the current buffer. Prompts for a new name. Does
not affect the filename associated with the buffer. Use ":f"
to do that.
This command is useful for renaming the "[Output]" buffer, if
you wish to preserve its contents, but run a new command.
:b Edit a buffer. Recalls the named buffer. Does not look for
a file of that name. Will find "invisible" buffers.
:ki Kill a buffer. Remove the buffer and its contents from the
editor. Will ask if changes to the buffer should be discarded.
Currently, a buffer that is being displayed cannot be killed.
* Display a list of all buffers, or make that display go away
if it's already present. Leave your finger on the key, and
it's easy to create and destroy the list. The buffers are
numbered; the numbers correspond to the history numbers
shown and used by the '_' command, described above. (If
the buffer number is greater than 9, then the "nn_" form of
the '_' command must be used, since '_' will only accept a
single following digit.) Note that since the buffer names
are displayed in order of use, the list can quickly grow
"stale" -- the numbers may be meaningless if buffer
switching has been done since the last display of the list.
The program version is also displayed with this command.
^A-* Always display a list of all buffers. Useful for updating the
list if it's already on the screen but may be out of date.
Any argument will cause the list to include _all_ buffers,
even those normally considered "invisible". (For example,
macros are stored in "invisible" buffers.)
Window manipulation commands:
-----------------------------
^T Make Two windows. Splits the current window in half. This
is the usual way to create a new window.
^K Get rid of (Kill) this window.
^O Make this the Only window on the screen.
The emacs-style commands ^X-2, ^X-0, and ^X-1 are also
included, and are synonymous with ^T, ^K, and ^O.
^N Go to the next window on the screen.
^P Go to the previous window on the screen.
These two commands may be disturbing to vi users who use
^N and ^P to move between lines. See the examples under
Key Rebinding for how to fix this.
v Make the current window smaller.
V Make the current window larger.
^A-^D Scroll the next window down half a screen.
^A-^U Scroll the next window up half a screen.
^A-^E Scroll the next window up one line.
^A-^Y Scroll the next window down one line.
(The previous four commands are useful when comparing two buffers.
Mnemonic -- think of them as affecting the "A"lternate window.)
zH zM zL These are synonyms for vi's 'z+'